package com.pig4cloud.pig.admin.api.feign;

import com.pig4cloud.pig.admin.api.entity.SysDictItem;
import com.pig4cloud.pig.common.core.constant.ServiceNameConstants;
import com.pig4cloud.pig.common.core.util.R;
import com.pig4cloud.pig.common.feign.annotation.NoToken;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;

import java.util.List;

/**
 * 远程字典服务接口
 * <p>
 * 通过Feign客户端调用UPMS服务的数据字典管理功能，提供字典数据的远程查询服务。
 * 主要用于各微服务获取系统字典数据，实现字典的统一管理和共享
 * </p>
 *
 * @author lengleng
 * @date 2025/05/30
 */
@FeignClient(contextId = "remoteDictService", value = ServiceNameConstants.UPMS_SERVICE)
public interface RemoteDictService {

	/**
	 * 根据字典类型查询字典项
	 * <p>
	 * 通过字典类型编码获取该类型下的所有字典项，用于下拉框、单选框等控件的数据源。
	 * 使用@NoToken注解表示该接口为内部服务调用，不需要认证
	 * </p>
	 * 
	 * @param type 字典类型编码，如user_status、sys_log_type等
	 * @return 包含该类型所有字典项的列表
	 */
	@NoToken
	@GetMapping("/dict/remote/type/{type}")
	R<List<SysDictItem>> getDictByType(@PathVariable("type") String type);

}
